package com.gengzp.system.mapper;

import com.gengzp.common.model.task.entity.ScheduledTask;
import com.gengzp.common.model.task.req.PageScheduledTaskReq;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * @ClassName ScheduledTaskMapper
 * @Description 定时任务管理模块 Mapper 层接口
 * @Author gengzp
 * @Date 2025/9/30 11:27
 */
@Mapper
public interface ScheduledTaskMapper {

    /**
     * 插入一条定时任务
     *
     * @param scheduledTask 定时任务信息
     */
    void insertScheduledTask(ScheduledTask scheduledTask);

    /**
     * 根据id编辑定时任务
     *
     * @param scheduledTask 定时任务信息
     */
    void updateScheduledTaskById(ScheduledTask scheduledTask);

    /**
     * 根据id编辑定时任务开关状态
     *
     * @param taskId 任务id
     * @param status 开关状态
     */
    void updateScheduledTaskStatusById(@Param("taskId") Long taskId,
                                       @Param("status") String status);

    /**
     * 执行定时任务后的更新
     * <p> 该方法会更新任务执行的相关字段, 并为执行次数进行累加 </p>
     * <p> 该方法不会更新修改时间和操作人等字段 </p>
     *
     * @param scheduledTask 定时任务信息
     */
    void updateScheduledTaskAfterExecute(ScheduledTask scheduledTask);

    /**
     * 根据id删除定时任务
     *
     * @param taskId 任务id
     */
    void deleteScheduledTaskById(@Param("taskId") Long taskId);

    /**
     * 根据任务 id 查询任务信息
     *
     * @param id 任务id
     * @return 任务信息
     */
    ScheduledTask selectScheduledTaskById(@Param("id") Long id);

    /**
     * 根据任务名查询任务信息
     *
     * @param taskName 任务名
     * @return 任务信息
     */
    ScheduledTask selectScheduledTaskByTaskName(@Param("taskName") String taskName);

    /**
     * 根据任务 uri 查询任务信息
     *
     * @param uri 任务 uri
     * @return 任务信息
     */
    ScheduledTask selectScheduledTaskByUri(@Param("uri") String uri);

    /**
     * 分页查询定时任务
     *
     * @param req 分页查询参数
     * @return 定时任务列表
     */
    List<ScheduledTask> pageQueryScheduledTask(PageScheduledTaskReq req);

    /**
     * 查询所有定时任务
     *
     * @return 定时任务列表
     */
    List<ScheduledTask> selectAllScheduledTask();

    /**
     * 查询所有需要执行的定时任务
     *
     * @return 定时任务列表
     */
    List<ScheduledTask> selectNeedExecuteScheduledTask();

}
